home *** CD-ROM | disk | FTP | other *** search
/ Sunday Savers: Singing Fun! / Sunday Savers: Singing Fun!.iso / mac / Xtras / Buddy API 3.7 / Buddy API Docs.swf / texts / 1712.txt < prev    next >
Encoding:
Text File  |  2004-08-31  |  2.8 KB  |  111 lines
  1. 190
  2. --- RECORDSEPARATOR ---
  3.  
  4. --- RECORDSEPARATOR ---
  5. WinHandle 
  6. --- RECORDSEPARATOR ---
  7. Platform:
  8. --- RECORDSEPARATOR ---
  9.  
  10. --- RECORDSEPARATOR ---
  11. Windows and Macintosh
  12. --- RECORDSEPARATOR ---
  13.  
  14. --- RECORDSEPARATOR ---
  15. Description:
  16. --- RECORDSEPARATOR ---
  17.  
  18. --- RECORDSEPARATOR ---
  19. baWinHandle returns the main Director window or the Authorware presentation 
  20. --- RECORDSEPARATOR ---
  21. window.
  22. --- RECORDSEPARATOR ---
  23.  
  24. --- RECORDSEPARATOR ---
  25. Usage:
  26. --- RECORDSEPARATOR ---
  27.  
  28. --- RECORDSEPARATOR ---
  29. Result = baWinHandle()
  30. --- RECORDSEPARATOR ---
  31.  
  32. --- RECORDSEPARATOR ---
  33. Arguments:
  34. --- RECORDSEPARATOR ---
  35.  
  36. --- RECORDSEPARATOR ---
  37. Void.
  38. --- RECORDSEPARATOR ---
  39.  
  40. --- RECORDSEPARATOR ---
  41. Returns:
  42. --- RECORDSEPARATOR ---
  43.  
  44. --- RECORDSEPARATOR ---
  45. Integer.
  46. --- RECORDSEPARATOR ---
  47.  
  48. --- RECORDSEPARATOR ---
  49. Examples:
  50. --- RECORDSEPARATOR ---
  51.  
  52. --- RECORDSEPARATOR ---
  53. Director: 
  54. --- RECORDSEPARATOR ---
  55. set Win = baWinHandle() 
  56. --- RECORDSEPARATOR ---
  57. Authorware: 
  58. --- RECORDSEPARATOR ---
  59. Win := baWinHandle()
  60. --- RECORDSEPARATOR ---
  61.  
  62. --- RECORDSEPARATOR ---
  63. Notes:
  64. --- RECORDSEPARATOR ---
  65.  
  66. --- RECORDSEPARATOR ---
  67. Use this function to get the Director window for use with the other window 
  68. --- RECORDSEPARATOR ---
  69. manipulation functions. 
  70. --- RECORDSEPARATOR ---
  71. In the UCD version, this function returns the Authorware presentation window when 
  72. --- RECORDSEPARATOR ---
  73. packaged, but the main Authorware window during authoring. When using Buddy 
  74. --- RECORDSEPARATOR ---
  75. window functions on the Authorware window, you should use baWinHandle() rather 
  76. --- RECORDSEPARATOR ---
  77. than the system WindowHandle variable. 
  78. --- RECORDSEPARATOR ---
  79. This is necessary because in authoring mode, the presentation window is a child of 
  80. --- RECORDSEPARATOR ---
  81. the main Authorware window. This causes problems with functions that rely on a 
  82. --- RECORDSEPARATOR ---
  83. specific window being active, because Windows thinks the active window is 
  84. --- RECORDSEPARATOR ---
  85. actually the main Authorware window, not the presentation window. By using this 
  86. --- RECORDSEPARATOR ---
  87. function instead of the system WindowHandle variable, you can create a file that 
  88. --- RECORDSEPARATOR ---
  89. behaves correctly in both authoring and runtime modes. 
  90. --- RECORDSEPARATOR ---
  91. For example, if the presentation window is active, baActiveWindow() and 
  92. --- RECORDSEPARATOR ---
  93. WindowHandle will not be the same during authoring, but will be when packaged. 
  94. --- RECORDSEPARATOR ---
  95. However, baActiveWindow() and baWinHandle() will be the same in both authoring 
  96. --- RECORDSEPARATOR ---
  97. and packaged modes. 
  98. --- RECORDSEPARATOR ---
  99. The baWinHandle function only works in version 3.0 or later of Authorware - use 
  100. --- RECORDSEPARATOR ---
  101. the baAw2Window function in earlier versions.
  102. --- RECORDSEPARATOR ---
  103.  
  104. --- RECORDSEPARATOR ---
  105. See also:
  106. --- RECORDSEPARATOR ---
  107.  
  108. --- RECORDSEPARATOR ---
  109. baStageHandle 
  110. --- RECORDSEPARATOR ---
  111. baAw2Window